home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / pp12.zip / PP.DOC < prev    next >
Text File  |  1992-12-30  |  14KB  |  278 lines
  1.        ▄▄▄▄▄                 ▄▄▄▄▄ ▄▄
  2.        ██  █ ▄▄▄▄▄ ▄▄    ▄ ▄▄▄▄▄ ▄▄▄▄ ██  █ ██  ▄▄▄▄▄ ▄▄  ▄ ▄▄▄▄▄ ▄▄▄▄
  3.        ███▄█ ██  █ ██ █ █ ██▄▄█ ██   ███▄█ ██  ▄▄▄██ ██  █ ██▄▄█ ██
  4.        ███   ███▄█ ████▄█ ███▄▄ ███  ███   ███ ███▄█ ███▄█ ███▄▄ ███
  5.                              ▄▄▄▄█
  6.  
  7.         --- When size & performance DO make a difference ---
  8.  
  9.  
  10.   FOREWORD:
  11.   ---------
  12.   As I'm not particularly interested in writing DOCs, I'll try to make this
  13.   a short one. I won't explain what these modules are, because I assume you
  14.   wouldn't have even downloaded this program if you didn't already know. :)
  15.   The player is made by the coders of THE ELECTROMOTIVE FORCE (EMF). Had to
  16.   mention that, too. ;-)
  17.  
  18.  
  19.   POWERPLAYER IN A NUTSHELL:
  20.   --------------------------
  21.   We decided that it was about time to release a MOD-player which plays the
  22.   modules exactly as they should be played.  We also think that most people
  23.   don't need scopes, equalizers and other fancy graphics on the screen when
  24.   playing modules - they just want to "play 'n' go!" ;-)  So we focused  on
  25.   finetuning the music routine itself to the extreme, and I sincerely think
  26.   that we  DID  succeed in that.  The player is very fast,  it eats up only
  27.   31 kilobytes of memory (plus the module, of course),    and what's the most
  28.   important thing - the modules  DO sound  just  like  they should.  I have
  29.   tested several module players with nearly  a thousand MOD and STM files -
  30.   PP seems to be the only one to play all of them correctly.
  31.  
  32.  
  33.   FUTURE PLANS:
  34.   -------------
  35.   In the future we will first implement stereo output to the player. Stereo
  36.   output is missing from this release simply  because  all of us have plain
  37.   Sound Blasters. SB Pro support  should be in the next major release - and
  38.   maybe PAS16 support also. Gravis Ultrasound will eventually be supported,
  39.   too, but we will first  have    to get our copies of  GUS  and    then try to
  40.   fetch some programming docs for it (which probably won't be easy; it took
  41.   us months to gather enough information  for the normal Sound Blaster when
  42.   we started programming the music system).  Support  for additional module
  43.   formats  (like  Amiga's Oktalyzer  and the forthcoming ScreamTracker 3.0)
  44.   will also be added.    And don't even    ask us to make    PC-speaker  or 286-
  45.   support! We won't.  The music  system's source  code (pure 386-assembler)
  46.   might be for sale - it's just a question of money...
  47.  
  48.  
  49.   HOW TO USE POWERPLAYER:
  50.   -----------------------
  51.   Using the  program is pretty simple  -  Just type in "PP filename", where
  52.   filename is the module you want to play. Quite simple and straighforward?
  53.   The player will start by searching the module from the current directory;
  54.   if it does not find it there, it will try the default module path,  which
  55.   can be specified in the configuration file. The default extension is MOD,
  56.   so you don't necessarily need to type  the extension at all.  PowerPlayer
  57.   uses Sound Blaster by default; if you want to use Covox or change playing
  58.   frequency or set the default module directories,  you must  either run PP
  59.   with the /C parameter or make the changes with your favorite ASCII editor
  60.   for example QEdit.
  61.  
  62.  
  63.   ADDITIONAL HINTS FOR USAGE:
  64.   ---------------------------
  65.   1) If you notice that some modules are playing  too slow or too fast, try
  66.      the /P override, which will disable ProTracker's extended tempos. Some
  67.      older NoiseTracker modules (e.g. klisje.mod)  may  use  speeds like 20
  68.      or 90,  even though  all speeds in the range of 20-FF are reserved for
  69.      extended BPM tempos in PT!  Naturally that  kind of modules will sound
  70.      wrong if they are played as Amiga's ProTracker would play them. That's
  71.      why we had to  include a switch for disabling the extended tempos. And
  72.      there's no way to detect if extended  tempos  should  or should not be
  73.      used; you have to decide it yourself. Fortunately non-standard modules
  74.      like Klisje.mod are quite rare and therefore you won't usually need to
  75.      bother with this option.
  76.  
  77.   2) If you have some modules  which are made on PCs  (the vast majority is
  78.      made on Amiga; say, 996 MODs out of 1000),  for example  with ModEdit,
  79.      you might want to experiment with the /O command line parameter.  This
  80.      option will force the player to  enable two extra octaves;  Amiga MODs
  81.      use only three octaves, whereas MODs made on PCs may use five. Usually
  82.      you won't hear any difference,  should  the module use five octaves or
  83.      not,  but if you notice some module playing  "out of tune",  try using
  84.      the /O override and see if it helps.
  85.  
  86.   3) SB Pro-users:  remember to turn on the SB Pro's filter using the "SBP-
  87.      SET" program. Otherwise the sound will be somewhat distorted.  This is
  88.      a known bug and will be fixed in the near future.
  89.  
  90.   4) Hint for 4DOS-users:   write the following lines in your AUTOEXEC.BAT:
  91.      (replace  "c:\bin\"  with the directory where your copy of PP resides)
  92.      SET .mod=c:\bin\pp.exe
  93.      SET .stm=c:\bin\pp.exe
  94.      SET .oct=c:\bin\pp.exe
  95.      SET .wow=c:\bin\pp.exe
  96.      Now, when you want to play a module,  you just  type  the    name of the
  97.      desired module,  and the music  will start!  Executable extensions are
  98.      really handy, aren't they? (Note: if you're NOT using 4DOS yet, go get
  99.      it somewhere immediately, because using a PC without 4DOS is PAIN!!!!)
  100.  
  101.   5) PowerPlayer is the most suitable choice for playing really big modules
  102.      which can't be loaded with other players.  First, PP requires far less
  103.      memory than other players;  second,  you can use VIDRAM.COM or similar
  104.      to get 96 kB more base RAM.  Most other players use VGA graphics,  and
  105.      therefore VIDRAM can't be used.  Some  users  have  noticed  that when
  106.      VIDRAM is loaded, the screen goes black when loading a module. Haven't
  107.      had time to  examine the problem,  but you  can  get  the text visible
  108.      again with the CLS command, so that's only a minor nuisance...
  109.  
  110.  
  111.   COMMAND LINE OPTIONS:
  112.   ---------------------
  113.   Usage: PP [-C] [-P] [-O] [-Sn] [-Dn] [-In] [-Mn] filename
  114.  
  115.      "Filename" is the module file to be played.
  116.  
  117.      -C lets you update the configuration file (PP.CFG).
  118.      -P disables the ProTracker's extended tempos (look above for more info).
  119.      -O forces the player to use 5-octave mode (look above for more info).
  120.      -Sn forces the player  to    use a certain mixing frequency, where n is
  121.          the frequency either in Hz or kHz (eg. -S16000 is the same as -S16).
  122.      -Dn forces the player to use a certain output device:
  123.  
  124.         -D1 = Use Sound Blaster
  125.         -D2 = Use Covox DAC on LPT1
  126.         -D3 = Use Covox DAC on LPT2
  127.  
  128.      -In forces the player to use a certain IRQ when playing with SB;
  129.  
  130.     -I2 = Use IRQ 2
  131.     -I3 = Use IRQ 3
  132.     -I5 = Use IRQ 5
  133.     -I7 = Use IRQ 7
  134.  
  135.      -Mn is the module    type override switch,  where n is the  number of the
  136.       desired module type. You should use this if the player fails to detect
  137.       the module's type.  Do not use this option unless you know what you're
  138.       doing.
  139.  
  140.     -M0 = STM (ScreamTracker 2.x)
  141.     -M1 = normal 4-channel .MOD file;
  142.     -M2 = MOD file with 15 instruments;
  143.     -M3 = An 8-channel WOW or OctaComposer module.
  144.  
  145.   NOTE: Both switch characters ('-' and '/') are accepted.
  146.     The options can be in any order, before or after the filename.
  147.  
  148.  
  149.   FEATURES OF PP (mainly for programmers and composers):
  150.   ------------------------------------------------------
  151.   Supports the following module formats:
  152.    o SoundTracker
  153.    o NoiseTracker
  154.    o StarTrekker
  155.    o ProTracker
  156.    o OctaComposer
  157.    o ScreamTracker (note: these are played in the same way as MODs!)
  158.    o 8-channel .WOW modules (converted from .669 format)
  159.    o ...and compatibles
  160.  
  161.   In addition, several features not so commonly
  162.   supported by PC module players are available:
  163.    o Modules with either 15 or 31 instruments
  164.    o Samples which are longer than 64 kB
  165.    o Modules with over 64 patterns (PT2.2 100-pattern mode)
  166.    o ProTracker's FineTune
  167.    o ProTracker's extended speeds (10-1F in vblanks, 20-FF in BPMs)
  168.    o Extended Vibrato & Tremolo waveforms
  169.    o All other extended commands of ProTracker, except FunkIt.
  170.    o A very fast & reliable DOS-shell (Note: COMSPEC must be set!)
  171.  
  172.   Music can be output via a Sound Blaster card or a DAC in the printer port
  173.   (either LPT1 or LPT2).  The player hasn't been tested with  Thunder Board
  174.   or Pro Audio Spectrum, but it should    work  on them.    If it doesn't, they
  175.   are not Sound Blaster compatible which is not our fault. :-)
  176.  
  177.  
  178.   LEGAL STUFF:
  179.   ------------
  180.   PP is copyright (c) 1992 by Tomi Aarnio, Teemu Valtonen and Petri Suni.
  181.  
  182.   PP is distributed  as Shareware,  meaning that you can use the player for
  183.   a trial period of FOUR WEEKS.  If you  continue to use it after that, you
  184.   should register it by paying $10 (50FIM) to the authors. Instructions for
  185.   registering  can be  found  at the end of this file.    Please    support the
  186.   Shareware concept!
  187.  
  188.   You can  distribute PP  in any way you wish,    for  example  via  BBSes or
  189.   various networks.  In fact, we strongly recommend you to copy the program
  190.   to all your friends,    neighbors and acquaintances,   as well as uploading
  191.   it to every BBS system you're visiting!
  192.  
  193.   DISCLAIMER:    The authors do not take any responsibility for the possible
  194.   (although highly unlikely)  damage or  data loss  caused  by the program.
  195.   You use PowerPlayer on your own responsibility.
  196.  
  197.  
  198.   CONTACTING THE AUTHORS:
  199.   -----------------------
  200.   If you have any comments,  bug  reports  or  ideas  on how to improve the
  201.   player,  you should  contact us immediately, and we will try to answer as
  202.   soon as possible.  I (Tomi Aarnio)  handle the "PR-stuff",  so you should
  203.   contact me in one of the following ways:
  204.  
  205.   mail:         | phone (voice only!): | BBS:
  206.   --------------+----------------------+-----------------------------------
  207.   Tomi Aarnio   | +358-(9)21-580 100   | +358-(9)21-827 419 / 8N1 / V.32bis
  208.   Seljatie 3 B  |                      | +358-(9)21-827 183 / 8N1 / V.32
  209.   SF-20900 Turku|                      | (24 hours a day, 7 days a week)
  210.   Finland       |                      | (DIANA available for Finns)
  211.   --------------+----------------------+-----------------------------------
  212.                                        | SBC-Net: 14:1510/400
  213.                                        | FidoNet: 2:222/151
  214.                                        +-----------------------------------
  215.  
  216.   Remember to call our distribution site, too:
  217.  
  218.   SB Center ---> +358-(9)42-14528 / 24h / V.32bis / SysOp: Kari Sorsimo
  219.  
  220.  
  221.   HOW TO REGISTER:
  222.   ----------------
  223.   The easiest way to pay the registration fee is to send the money ($10) to
  224.   my bank account using a bank giro (remember to state your address so that
  225.   we will know where to send the disk!):
  226.  
  227.         From Finland:        From abroad:
  228.  
  229.         TOP Turku        OKOBANK / Turku
  230.         571004-5480249        Finland
  231.                     571004-5480249
  232.  
  233.   We can not handle  VISA or any other credit cards,  but we will accept US
  234.   dollars and Finnish marks (and why not other currencies as well) sent via
  235.   mail. We prefer US dollars, but you can send the sum in your own currency
  236.   if you really want to. Just don't send any coins! Please allow  two weeks
  237.   at the maximum for delivery.    Remember  to  specify floppy disk type (3½"
  238.   1.44MB or 5¼" 1.2MB).
  239.  
  240.  
  241.   WHY TO REGISTER:
  242.   ----------------
  243.   1) You will get rid of the annoying beep and delay when quitting,
  244.      and in addition to this you will save about 1000 bytes of memory.
  245.   2) You will receive the next upgrade of PowerPlayer FREE OF CHARGE,
  246.      and all the major upgrades after that for only $5 or 25 FIM!
  247.   3) You will support the Shareware concept  and encourage us to write more
  248.      fine utilities and other stuff.  And ten bucks isn't that much, is it?
  249.  
  250.   As the  PowerPlayer  doesn't require very  much  disk space the remaining
  251.   disk space can be filled with modules of your choice. Pick your favorites
  252.   from the  file  MODS.LST and we will    include those  modules on the disk.
  253.   All modules are purely in their original form;  no  conversions have been
  254.   made.  (Of course the modules will be  packed  so  that more modules will
  255.   fit on the disk.)  If you can't decide which    modules  you  would like to
  256.   have, we can make a collection of high quality modules for you!  The file
  257.   MODS.LST naturally includes only a  small fraction of my collections, but
  258.   I qualified only some of the best modules to the list.
  259.  
  260.   BTW, if you don't already have the demos & intros of our little demo team
  261.   (The Electromotive Force = EMF),  you might  want  us to  include them on
  262.   the disk as well:
  263.  
  264.   EMFINTRO.EXE --> Our first intro, released in October, 1991. Size: 70k.
  265.   DELIRIUM.EXE --> Intro/dentro coded in the spring of 1992, size: 116k.
  266.   EMF_ID.EXE   --> Our major product so far,  includes    six  parts and some
  267.            quite cool effects, fast code, nice gfx & sfx, yet takes
  268.            up only 150k of disk space!
  269.  
  270.   GREETINGS:
  271.   ----------
  272.   Greetings must go to all beta testers  who  helped us  getting the player
  273.   as bug-free as possible:  Jussi Heino, Jani Väisänen, Sami Virtanen, Jani
  274.   Lehmuskoski, Jani Mattsson and Esa Tuokko.  Quick group  greetings to the
  275.   following teams: The Future Crew, Triton, Renaissance, Cascada, Hysteria,
  276.   The Phoney Coders and every other group working on the PC scene!
  277.  
  278.